Inside Macintosh: QuickTime Components /

Chapter 8 - Video Digitizer Components / Video Digitizer Components Reference

Video Digitizer Component Functions / Controlling Color

VDGetCLUTInUse

The VDGetCLUTInUse function allows an application to obtain the color lookup table used by a video digitizer component. By using the Palette Manager, the application can then set the destination so that it uses the same lookup table.

pascal VideoDigitizerError VDGetCLUTInUse 
                              (VideoDigitizerComponent ci,
                               CTabHandle *colorTableHandle);

ci

Specifies the video digitizer component for the request. Applications obtain this reference from the Component Manager's OpenComponent function.

colorTableHandle

Contains a pointer to a field that is to receive a color table handle. The video digitizer component returns a handle to its color lookup table. Applications can then set the destination to use this returned color table. Your application is responsible for disposing of this handle.

DESCRIPTION

In general, applications use this function only when a video digitizer component does not allow applications to specify lookup tables with the VDUseThisCLUT function. Applications can determine whether a digitizer component supports specified lookup tables by examining the component's output capability flags. Specifically, if the digiOutDoesILUT flag is set to 1, the digitizer component allows applications to specify color lookup tables. Applications can use the VDGetCurrentFlags function (described on page 8-25) to obtain the input capability flags of a component.

RESULT CODES

noErr	0	No error
memFullErr	-108	Not enough room in heap zone
digiUnimpErr	-2201	Function not supported

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help